package com.qk.service;

import com.qk.common.PageResult;
import com.qk.domain.user.UserDO;
import com.qk.dto.user.UserDTO;
import com.qk.dto.user.UserLoginDTO;
import com.qk.entity.User;
import com.qk.vo.user.UserLoginVO;
import org.springframework.stereotype.Service;

import java.util.List;

/**
 * @Author SweetHurt
 * @Date 2025-10-07 14:30:31
 * @Description 针对表【user(用户表)】的数据库操作Service
 */
@Service
public interface UserService {

    /**
     * 分页查询所有用户
     *
     * @param userDTO 查询参数
     * @return PageResult 分页结果
     */
    PageResult<UserDO> listPage(UserDTO userDTO);

    void addUser(User user);

    /**
     * 批量删除用户
     *
     * @param ids 用户id
     */
    void deleteUsers(String ids);

    /**
     * 根据id查询用户
     *
     * @param id 用户id
     * @return UserDO 用户信息
     */
    UserDO getById(Integer id);

    /**
     * 修改用户
     *
     * @param user 用户信息
     */
    void updateById(User user);

    /**
     * 根据角色查询用户
     *
     * @param label 角色标签
     * @return List<UserDO> 用户列表
     */
    List<UserDO> getByRole(String label);

    /**
     * 根据部门查询用户
     *
     * @param deptId 部门id
     * @return List<UserDO> 用户列表
     */
    List<UserDO> getByDept(Integer deptId);

    /**
     * 登录
     *
     * @param userLoginDTO 登录参数
     * @return UserLoginVO 登录结果
     */
    UserLoginVO login(UserLoginDTO userLoginDTO);
}
